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By  Carmelo  F.  Ferrigno 


ABSTRACT 

This  report  describes  the  machine-readable  files  developed  for  the  High 
Plains  Regional  Aquifer-System  Analysis  project  that  are  stored  on  two  mag¬ 
netic  tapes  and  are  available  from  the  U.S.  Geological  Survey.  The  first  tape 
contains  computer  programs  that  were  used  to  prepare,  store,  retrieve,  orga¬ 
nize,  and  preserve  the  areal  interpretive  data  collected  by  the  project  staff. 
The  second  tape  contains  134  data  files  that  can  be  divided  into  five  general 
classes:  (1)  Aquifer-geometry  data,  (2)  aquifer  and  water  characteristics, 

(3)  water  levels,  (4)  climatological  data,  and  (5)  land-  and  water-use  data. 


INTRODUCTION 

The  machine-readable  files  described  in  this  report  were  assembled  as 
part  of  the  High  Plains  Regional  Aquifer-System  Analysis  (RASA)  project  and 
include  computer  programs  and  geohydrologic  data.  The  computer  programs  were 
used  to  manage  the  data  which  in  turn  were  used  to  generate  various  reports 
(see  "Selected  References"),  hydrologic  analyses,  and  aquifer  simulations. 

This  report  provides  a  description  of  the  characteristics  and  contents  of  two 
magnetic  tapes--the  computer  software  tape  and  the  data  tape. 

The  computer  software  tape  consists  of  29  files  of  programs  and  support¬ 
ing  files  that  were  used  to  prepare,  store,  retrieve,  organize,  and  preserve 
the  data  collected  and  compiled  by  the  High  Plains  RASA  project.  Each  com¬ 
puter  program  was  placed  in  a  separate  file;  the  supporting  files  were  com¬ 
bined  into  related  groups.  These  programs  are  described  and  documented  in  two 
reports  (Luckey  and  Ferrigno,  1982;  Ferrigno,  1986). 
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The  data  tape  consists  of  134  files  that  can  be  divided  into  five  general 
classes:  (1)  Aquifer-geometry  data,  (2)  aquifer  and  water  characteristics, 

(3)  water  levels,  (4)  climatological  data,  and  (5)  land-  and  water-use  data. 

A  description  of  these  classes  of  data  can  be  found  in  the  report  by  Luckey 
and  Ferrigno  (1982).  These  data  were  stored  in  a  data  base  that  was  managed 
using  a  commercial  data-base  management  system  (DBMS)  called  System  20001. 

The  magnetic  tapes  are  stored  at  the  U.S.  Geological  Survey’s  National 
Computer  Center,  Reston,  Va . ;  additional  information  and  copies  of  individual 
files  or  tapes  may  be  obtained  from:  Office  of  the  Chief  Hydrologist,  Water 
Resources  Division,  U.S.  Geological  Survey,  Mail  Stop  409,  National  Center, 
12201  Sunrise  Valley  Drive,  Reston,  VA  22092. 


PHYSICAL  CHARACTERISTICS  OF  THE  MAGNETIC  TAPES 


The  physical  characteristics  of  the  magnetic  tapes  were  chosen  to  make 
the  tapes  compatible  with  a  wide  variety  of  computer  systems.  For  example, 
the  density  and  block-size  values  are  small  so  that  the  tapes  can  be  read 
using  a  minicomputer  or  a  microcomputer. 

The  magnetic  tapes  have  the  following  physical  characteristics: 


Tracks : 
Density: 
Labels : 

Record  Length  (Fixed): 

Block  Size: 
Code : 
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1600  BPI  (bits  per  inch) 

None 

80  bytes 

2,000  bytes 

ASCII. 


The  magnetic  tapes  were  generated  on  an  Amdahl  470V/7  computer  located  at 
the  U.S.  Geological  Survey's  National  Computer  Center  in  Reston,  Va.  Each 
computer  program,  supporting  file,  or  data  file  was  initially  stored  as  a 
sequential  file  or  member  of  a  partitioned-data  set  on  a  disk-storage  device. 
The  files  were  copied  to  a  magnetic  tape  using  an  IBM  utility  program  called 


IEBGENER. 


DATA-BASE  PROGRAMS  AND  SUPPORTING  FILES 

The  machine-readable  files  that  are  stored  on  magnetic-tape  number  220452 
can  be  divided  into  four  categories:  (1)  Source  code  for  computer  programs, 
(2)  IBM  Job  Control  Language  (JCL)  for  executing  the  programs,  (3)  files  con¬ 
taining  variable  declarations  used  by  some  of  the  computer  programs,  and 
(4)  miscellaneous  information.  Listed  in  table  1  are  the  files  in  the  order 
in  which  they  were  stored  on  the  magnetic  tape. 


^he  use  of  brand  names  in  this  report  is  for  identification  purposes 
only  and  does  not  constitute  endorsement  by  the  U.S.  Geological  Survey. 
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The  computer  programs  (files  1  through  23  in  table  1)  can  be  divided  into 
three  categories:  (1)  Data-preparation  programs,  (2)  programs  that  interact 
with  the  data  base  and  the  DBMS,  and  (3)  data-application  programs.  These 
programs  were  written  in  either  Fortran  IV  or  PL/1.  A  detailed  description  of 
the  programs  can  be  found  in  two  reports  published  by  the  High  Plains  RASA 
project  (Luckey  and  Ferrigno,  1982;  Ferrigno,  1986). 

Files  1  through  5  on  magnetic-tape  number  220452  contain  the  data- 
preparation  programs.  All  of  these  programs  were  written  in  Fortran  IV. 

These  programs  were  part  of  an  automated  procedure  that  was  used  to  generate 
some  of  the  data  for  the  High  Plains  RASA  project.  The  source  materials  for 
the  data  usually  were  geohydrologic  maps.  The  output  from  the  last  data- 
preparation  program  (file  5  in  table  1)  consists  of  data  sets  in  the  format 
needed  for  loading  into  the  data  base. 

Files  6  through  16  on  magnetic-tape  number  220452  contain  the  programs 
that  interact  with  the  data  base  and  the  DBMS.  These  programs  were  linked  to 
System  2000  (the  DBMS)  by  means  of  subroutines  provided  by  the  developers  of 
System  2000.  The  Edit  and  Retrieval  Programs  (files  6,  9,  and  10  in  table  1) 
were  written  in  Fortran  IV.  All  other  programs  in  this  group  (files  7,  8, 
and  11  through  16  in  table  1)  were  written  in  PL/1.  The  programs  in  files  6 
through  16  perform  functions  such  as  loading,  retrieving,  and  updating  data 
stored  in  the  data  base. 

Files  17  through  23  on  magnetic-tape  number  220452  contain  the  programs 
that  use  data  retrieved  from  the  data  base.  All  of  these  programs  were 
written  in  PL/1.  Among  other  functions,  these  programs  can  be  used  for  mathe¬ 
matical  manipulations  and  graphical  display  of  data.  The  Graphics  Program 
uses  two  computer  programs  produced  by  Calcomp  Computer  Products,  Inc. 

Files  24  through  26  on  magnetic-tape  number  220452  contain  the  pro¬ 
cedures,  written  in  IBM  JCL,  to  execute  the  computer  programs.  These  pro¬ 
cedures  were  written  to  be  used  on  the  Amdahl  470V/7  computer  in  Reston,  Va., 
and  make  reference  to  files  that  are  stored  on  a  3350-type  disk-storage 
device.  File  24  contains  the  procedures  for  executing  the  data-preparation 
programs.  File  25  contains  the  procedures  for  executing  the  programs  that 
access  the  data  base  and  the  DBMS.  File  26  contains  the  procedures  for 
executing  the  data-application  programs.  Files  27  and  28  on  magnetic-tape 
number  220452  contain  the  variable  declarations  needed  to  link  the  programs  in 
files  6  through  16  with  the  System  2000  DBMS. 

File  29  on  magnetic-tape  number  220452  contains  the  following  miscella¬ 
neous  information:  (1)  A  list  of  parameter  names,  (2)  the  data-base  defini¬ 
tion  in  the  form  required  by  System  2000,  (3)  the  list  of  error  messages  used 
by  the  Edit  and  Retrieval  Programs,  and  (4)  several  short  files  containing 
information  needed  by  the  IBM  procedures  for  the  programs  that  access  the  data 
base  and  the  DBMS.  Most  of  the  information  in  this  file  would  be  needed  only 
if  the  data  were  to  be  stored  in  a  data  base  managed  by  the  System  2000  DBMS. 
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Table  1 . --Data-base  programs  and  supporting  files 


File 

number 

1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 


Contents  and  documentation 


Digitizer  Data-Conversion  Program;  documented  in  Luckey  and 
Ferrigno  (1982,  p.  33). 

First  Data-Gridding  Program;  documented  in  Luckey  and  Ferrigno 
(1982,  p.  37). 

Second  Data-Gridding  Program;  documented  in  Luckey  and  Ferrigno 
(1982,  p.  40). 

Boundary-Matrix  Generation  Program;  documented  in  Luckey  and 
Ferrigno  (1982,  p.  43). 

Excess  Data-Elimination  Program;  documented  in  Luckey  and 
Ferrigno  (1982,  p.  45). 

Edit  Program;  documented  in  Luckey  and  Ferrigno  (1982,  p.  48). 
Load  Program;  documented  in  Luckey  and  Ferrigno  (1982,  p.  54). 
Load  Program  subroutines. 

Retrieval  Program;  documented  in  Luckey  and  Ferrigno  (1982, 

p .  61) . 

Retrieval  Program  subroutines. 

Instant-Update  Program;  documented  in  Luckey  and  Ferrigno  (1982, 

p .  66) . 

Instant-Update  Program  subroutines. 

Move  Program;  documented  in  Luckey  and  Ferrigno  (1982,  p.  77). 
Statistics  Program;  documented  in  Luckey  and  Ferrigno  (1982, 

p .  80) . 

General-Update  Program;  similar  program  documented  in  Ferrigno 
(1986,  p.  45). 

Reload  Program;  similar  program  documented  in  Ferrigno  (1986, 
p .  65 )  . 

Data-Transformation  Program;  documented  in  Luckey  and  Ferrigno 
(1982,  p.  83). 
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Fil 

numt 

18 

19 

20 

21 

22 

23 

24 

25 

26 

27 

28 

29 


Table  1 . --Data-base  programs  and  supporting  files-- Continued 


Contents  and  documentation 


Data-Transf ormation  Program  subroutines. 

Interpolation  Program;  documented  in  Luckey  and  Ferrigno  (1982, 
p.  83). 

Data-Manipulation  Program;  documented  in  Luckey  and  Ferrigno 
(1982,  p.  93). 

Data-Manipulation  Program--version  2;  similar  program  documented 
in  Ferrigno  (1986,  p.  77). 

Graphics  Program;  documented  in  Luckey  and  Ferrigno  (1982,  p.  97). 

Graphics  Program  subroutines  and  supporting  programs. 

IBM  procedures  for  data-preparation  programs;  documented  in 
Luckey  and  Ferrigno  (1982). 

IBM  procedures  for  programs  that  access  the  data  base  and  the 
data-base  management  system;  documented  in  Luckey  and  Ferrigno 
(1982). 

IBM  procedures  for  data-application  programs;  documented  in 
Luckey  and  Ferrigno  (1982). 

Variable  declarations  for  Fortran  programs  that  access  the  data 
base  and  the  data-base  management  system;  discussed  in  this 
report  on  page  3. 

Variable  declarations  for  PL/1  programs  that  access  the  data  base 
and  the  data-base  management  system;  discussed  in  this  report 
on  page  3. 

Miscellanea;  discussed  in  this  report  on  page  3. 
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DATA-BASE  PARAMETERS 


Listed  in  table  2  are  the  contents  of  magnetic-tape  number  220451.  This 
magnetic  tape  contains  a  sequential  version  of  the  data  originally  stored  in 
the  data  base. 

The  second  column  of  table  2  contains  the  study  unit.  The  study  unit 
identifies  the  geographic  area  that  is  covered  by  the  parameter.  The  study 
unit  has  three  possible  values:  (1)  HIPLAINS  indicates  that  the  data  cover 
the  entire  High  Plains  aquifer;  (2)  NEBRASKA  indicates  that  the  data  cover 
Chase,  Dundy,  and  Perkins  Counties  in  Nebraska;  and  (3)  TEXAS  indicates  that 
the  data  cover  Castro  and  Parmer  Counties  in  Texas. 

The  fourth  column  of  table  2  is  the  density  at  which  the  data  were  stored 
in  the  data  base.  The  possible  values  are  1  through  4.  A  density  of  1  indi¬ 
cates  one  value  for  each  3-degree  latitude-longitude  block  that  was  partially 
or  completely  within  the  area  defined  by  the  study  unit.  A  density  of  2  indi¬ 
cates  one  value  for  each  1-degree  latitude-longitude  block  that  was  partially 
or  completely  within  the  area  defined  by  the  study  unit.  A  density  of  3  indi¬ 
cates  one  value  for  each  10-minute  latitude-longitude  block  that  was  partially 
or  completely  within  the  area  defined  by  the  study  unit.  The  most  detailed 
data  were  stored  at  density  4.  A  density  of  4  indicates  one  value  for  each 
1-minute  latitude-longitude  block  that  was  partially  or  completely  within  the 
area  defined  by  the  study  unit.  A  further  discussion  of  the  density  concept 
can  be  found  in  Luckey  and  Ferrigno  (1982). 
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[MSL  =  mean  sea  level;  Mg/L  =  milligrams  per  liter;  URNRD  =  Upper  Republican  Natural  Resources  District; 
Gal/day/ft  =  gallons  per  day  per  foot;  HPUWCD  =  High  Plains  Underground  Water  Conservation  District] 
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All  of  the  data  files  were  produced  using  the  Retrieval  Program  (Luckey 
and  Ferrigno,  1982,  p.  61).  A  description  of  the  records  in  the  data  files 
can  be  found  in  Luckey  and  Ferrigno  (1982).  The  formats  of  these  records  are 
as  follows: 

001*:  First  master  record 


Columns 

FORTRAN 

format 

Content 

01-04 

A4 

001* 

05-10 

6X 

Blank 

11-40 

7A4 , A2 

Project  name 

41-49 

19 

Reserved  value  A  (Unused) 

50-60 

F11.3 

Reserved  value  B  (Unused) 

61-70 

2A4 , A2 

Reserved  value  C  (Unused) 

71-72 

2X 

Blank 

73-80 

18 

Sequence  number,  nondecreasing 

002*: 

Second  master 

record 

„  ,  FORTRAN 

Columns 

format 

Content 

01-04 

A4 

002* 

05-10 

6X 

Blank 

11-18 

2A4 

Study  unit 

19-48 

7A4 , A2 

Parameter  name 

49 

50-52 

11 

13 

Density  (see  page  6)  n 

Scale  factor  (value  x  10  ) 

53-62 

2A4 , A2 

Units  of  measurement  -  description 

63-72 

10X 

Blank 

73-80 

18 

Sequence  number,  nondecreasing 

17 


003* 


Third  master  record 


Columns 

FORTRAN 

format 

Content 

01-04 

A4 

003* 

05-10 

6X 

Blank 

11-25 

15X 

Blank 

26-30 

15 

Minimum 

31-35 

15 

Maximum 

36-40 

15 

Average 

41-47 

17 

Number  of  values 

48-55 

F8.2 

Standard  deviation 

56-62 

7X 

Blank 

63-67 

15 

Missing-value  indicator  (value  used  to  flag  missing 
data) 

68-72 

5X 

Blank 

73-80 

18 

Sequence  number,  nondecreasing 

050*:  Remarks  records 

Columns 

FORTRAN 

format 

Content 

01-04 

A4 

050* 

05-10 

6X 

Blank 

11-16 

A4,A2 

Date  of  remark  (MMDDYY) 

17-18 

2X 

Blank 

19-21 

13 

Remark  sequence  number 

22 

11 

Remark  record  number 

1  =  First  record  of  set 

2  =  Second  record  of  set 

3  =  Third  record  of  set 

4  =  Fourth  record  of  set 

5  =  Fifth  record  of  set 

23-72 

12A4 , A2 

Text  of  remark 

73-80 

18 

Sequence  number,  nondecreasing 

Note:  The  050*  records  must  come  in  sets  of  five. 


18 


100* 


Three-degree  block  record 


Columns 

FORTRAN 

format 

Content 

01-04 

A4 

100* 

05-10 

6X 

Blank 

11-16 

16 

Latitude  (DDMMSS) 

17 

IX 

Blank 

18-24 

17 

Longitude  (DDDMMSS) 

25 

IX 

Blank 

26-30 

15 

Minimum 

31-35 

15 

Maximum 

36-40 

15 

Average 

41-45 

15 

Number  of  values 

46-53 

F8.2 

Standard  deviation 

54-72 

19X 

Blank 

73-80 

18 

Sequence  number,  nondecreasing 

200* :  One 

:-degree  block 

record 

Columns 

FORTRAN 

format 

Content 

01-04 

A4 

200* 

05-10 

6X 

Blank 

11-16 

16 

Latitude  (DDMMSS) 

17 

IX 

Blank 

18-24 

17 

Longitude  (DDDMMSS) 

25 

IX 

Blank 

26-30 

15 

Minimum 

31-35 

15 

Maximum 

36-40 

15 

Average 

41-45 

15 

Number  of  values 

46-53 

F8.2 

Standard  deviation 

54-72 

19X 

Blank 

73-80 

18 

Sequence  number,  nondecreasing 

19 


350* 


Ten-minute  block  record-- 10-minute  data 


Columns 

FORTRAN 

format 

Content 

01-04 

A4 

350* 

05-10 

6X 

Blank 

11-16 

16 

Latitude  (DDMMSS) 

17 

IX 

Blank 

18-24 

17 

Longitude  (DDDMMSS) 

25 

IX 

Blank 

26-30 

15 

Minimum 

31-35 

15 

Maximum 

36-40 

15 

Average 

41-45 

15 

Number  of  values 

46-53 

F8.2 

Standard  deviation 

54-72 

19X 

Blank 

73-80 

18 

Sequence  number,  nondecreasing 

300* :  Ten-minute 

block  record-- 1-minute  data 

Columns 

FORTRAN 

format 

Content 

01-04 

A4 

300* 

05-10 

6X 

Blank 

11-16 

16 

Latitude  (DDMMSS) 

17 

IX 

Blank 

18-24 

17 

Longitude  (DDDMMSS) 

25 

IX 

Blank 

26-30 

15 

Minimum 

31-35 

15 

Maximum 

36-40 

15 

Average 

41-45 

15 

Number  of  values 

46-53 

F8.2 

Standard  deviation 

54-72 

19X 

Blank 

73-80 

18 

Sequence  number,  nondecreasing 

Note:  This  record  must  be  followed  by  exactly  ten  401*-410*  records. 
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401*- 4 10* 


One-minute  block  records 


Columns 

FORTRAN 

format 

Content 

01-04 

A4 

4xx*;  xx=(01 ,02 , . . . , 10) 

05-10 

6X 

Blank 

11-60 

1015 

Components  401-500;  see  note  below 

61-72 

12X 

Blank 

73-80 

18 

Sequence  number,  nondecreasing 

Note:  The  components,  401  through  500,  are  entered  at  10  components  per 

record  such  that  the  records  simulate  a  10-by-10  matrix  geographi¬ 
cally  overlaying  the  10-minute  latitude-longitude  block: 


Record 

Components 

401* 

401-410 

402* 

411-420 

403* 

421-430 

404* 

431-440 

405* 

441-450 

406* 

451-460 

407* 

461-470 

408* 

471-480 

409* 

481-490 

410* 

491-500 

Component  401  represents  the  northwestern  most  1-minute  block  of 
the  10-minute  block,  component  410  represents  the  northeastern  most 
1-minute  block,  component  491  represents  the  southwestern  most 
1-minute  block,  and  component  500  represents  the  southeastern  most 
1-minute  block  of  the  10-minute  block. 

Each  data  file  begins  with  the  master  records  001*,  002*,  and  003*. 
These  records  may  be  followed  by  remarks  records  consisting  of  sets  of  five 
050*  records.  These  records  will  be  followed  by  the  appropriate  combination 
of  the  100*,  200*,  350*,  300*,  and  401*-410*  records.  The  final  record  con¬ 
tains  only  a  999*.  The  actual  combination  of  records  depends  on  the  data 
density. 


SUMMARY 

Machine-readable  files  were  assembled  as  part  of  the  High  Plains  RASA 
project  and  are  stored  on  two  magnetic  tapes  that  are  available  from  the  U.S. 
Geological  Survey.  The  first  magnetic  tape  (number  220452)  contains  computer 
programs  that  were  used  to  prepare,  store,  retrieve,  organize,  and  preserve 
aerial  interpretive  data  collected  for  the  project.  The  second  magnetic  tape 
(number  220451)  contains  134  data  files  that  can  be  divided  into  five  general 
classes:  (1)  Aquifer-geometry  data,  (2)  aquifer  and  water  characteristics, 

(3)  water  levels,  (4)  climatological  data,  and  (5)  land-  and  water-use  data. 
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